home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / fractals / posterbr.lha / PosterBrot 1.6 / PosterBrot.doc < prev    next >
Encoding:
Text File  |  1994-06-10  |  4.7 KB  |  190 lines
  1. Table of contents
  2.  
  3. Copyright information
  4. Introduction
  5. Features
  6. System requirements
  7. Usage
  8. Notes
  9. Thanks to
  10. How to reach the author
  11. Revision history
  12.  
  13.  
  14. Copyright information
  15.  
  16. PosterBrot 1.6 - A Mandelbrot set poster generator
  17. Copyright © 1994 George Leonidas Coulouris
  18.  
  19.         The  author  is not responsible for any damage, whether direct
  20. or consequential, resulting from the use of this program.
  21.  
  22.         This  program is free software; you can redistribute it and/or
  23. modify  it under the terms of the GNU General Public License Version 2
  24. as published by the Free Software Foundation.
  25.  
  26.         This  program  is  distributed  in  the  hope  that it will be
  27. useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
  28. MERCHANTABILITY  or  FITNESS  FOR  A  PARTICULAR PURPOSE.  See the GNU
  29. General Public License for more details.
  30.  
  31.         You  should  have  received  a  copy of the GNU General Public
  32. License  along  with  this program; if not, write to the Free Software
  33. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  34.  
  35.  
  36. Introduction
  37.  
  38.         PosterBrot is a greyscale Mandelbrot set poster generator.  It
  39. will  generate  a  set of PGM image files, which, when printed, can be
  40. combined into a poster.
  41.  
  42.  
  43. Features
  44.  
  45.         -  Portable.   PosterBrot is written in ANSI C, and can ported
  46. to any platform which supports the standard.
  47.  
  48.         -  FPU support.  Directly uses the MC6888x, if available.
  49.  
  50.         -  Smooth.  PosterBrot colors by escape radius, rather than by
  51. escape  iteration.   This  method  produces extremely smooth gradients
  52. with fewer iterations per pixel.
  53.  
  54.  
  55. System requirements
  56.  
  57.         - AmigaDOS 2.0
  58.         - Software suitable for printing PGM images
  59.  
  60.  
  61. Usage
  62.  
  63.         PosterBrot  takes  one  command  line  argument, the file name
  64. under which to store the images.
  65.  
  66.         PosterBrot  will  then  prompt  for some information about the
  67. poster that you wish to generate.
  68.  
  69. Mandelbrot attributes:
  70.  
  71.         xmin :
  72.                 Real minimum (left edge) of the poster.
  73.  
  74.         xmax :
  75.                 Real maximum (right edge) of the poster.
  76.  
  77.         ymin :
  78.                 Imaginary minimum (bottom) of the poster.
  79.  
  80.         ymax :
  81.                 Imaginary maximum (top) of the poster.
  82.  
  83.         Maximum iterations/pixel :
  84.                 Maximum number of iterations per pixel.
  85.  
  86.  
  87. Poster attributes:
  88.  
  89.         Width  (pages) :
  90.                 Width of the poster, in pages.
  91.  
  92.         Height (pages) :
  93.                 Height of the poster, in pages.
  94.  
  95.  
  96. Page attributes:
  97.  
  98.         Width  (pixels) :
  99.                 Width of each page, in pixels.
  100.  
  101.         Height (pixels) :
  102.                 Height of each page, in pixels.
  103.  
  104. PosterBrot  will  then generate the image files.  PosterBrot will keep
  105. you informed about its progress.
  106.  
  107.         The  naming  convention  is  filename.x.y,  where  x and y are
  108. two-digit page indices.
  109.  
  110. Example:
  111.  
  112.         A 3 x 3 poster would be laid out like this:
  113.  
  114.         +-------+-------+-------+
  115.         |       |       |       |
  116.         |  0,0  |  1,0  |  2,0  |
  117.         |       |       |       |
  118.         +-------+-------+-------+
  119.         |       |       |       |
  120.         |  0,1  |  1,1  |  2,1  |
  121.         |       |       |       |
  122.         +-------+-------+-------+
  123.         |       |       |       |
  124.         |  0,2  |  1,2  |  2,2  |
  125.         |       |       |       |
  126.         +-------+-------+-------+
  127.  
  128. Such a poster would produce files like filename.00.00, filename.00.01,
  129. etc.
  130.  
  131.  
  132. Notes
  133.  
  134.         Keep in mind that PosterBrot is not a Mandelbrot set explorer.
  135. I  reccomend  that  you  find  your  coordinates  with  a program like
  136. MandelMania 4.1 (good) or Mand2000 (better).
  137.  
  138.         There  are a wealth of image processing tools which will allow
  139. you  to  print  the  PGM  images  that  PosterBrot generates.  ImageFX
  140. immediately  comes  to mind, but there are plenty of programs floating
  141. around which will do the job.
  142.  
  143.         To recompile PosterBrot (using SAS/C 6.3 or later)
  144.  
  145. on vanilla (non-FPU) systems:
  146.  
  147.         sc PosterBrot.c link
  148.  
  149. on MC6888x-equipped systems:
  150.  
  151.         sc DEF=USEFPU PosterBrot.c iteratec.a link
  152.  
  153.  
  154. Thanks to
  155.  
  156.         · Bill Talkiewicz
  157.         · Don Schmalberger
  158.  
  159.         · Bob Livingston - Rest in peace, my friend.
  160.  
  161.  
  162. How to reach the author
  163.  
  164. Send feedback, suggestions, flames, etc. to:
  165.  
  166.         deltax@hermes.acm.rpi.edu
  167.  
  168.  
  169. Help to put me through college! Send donations to:
  170.  
  171.         George L. Coulouris
  172.         Box 4499 Route 32
  173.         Catskill, NY 12414
  174.         USA
  175.  
  176.  
  177. Revision history
  178.  
  179. 1.0 - 1.2       Internal revisions.
  180.  
  181. 1.3             15 Jan 93.  First public release.
  182.  
  183. 1.4             21 May 94.  Removed progress report buffering.
  184.  
  185. 1.5             31 May 94.  Rewrote iteration function in
  186. floating-point assembler ( ~17% speed gain ).
  187.  
  188. 1.6             9 June 94.  Tightened assembler code, made PC-relative.
  189. Removed percentage indicator.
  190.